home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr38 / otd_15.zip / OTD.DOC < prev    next >
Text File  |  1993-05-08  |  41KB  |  1,407 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                       The Software Construction Co.
  13.  
  14.                               Presents ...
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                             On This Day (tm)
  26.                                Version 1.5
  27.                                 May 1993
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                             _______
  34.                        ____|__     |               (tm)
  35.                     --|       |    |-------------------
  36.                       |   ____|__  |  Association of
  37.                       |  |       |_|  Shareware
  38.                       |__|   o   |    Professionals
  39.                     -----|   |   | --------------------
  40.                          |___|___|    MEMBER
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                       The Software Construction Co.
  47.                               P.O. Box 160
  48.                        North Billerica, MA  01862
  49.                              CIS: 70313,3615
  50.                              GEnie: W.GEISER
  51.                      Internet: softcons@world.std.com
  52.  
  53.  
  54.  
  55.  
  56.   (C) Copyright 1990-1993 The Software Construction Co., All Rights Reserved.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.          1. Introduction                                             1
  63.          2. Command Line                                             2
  64.          3. Databases                                                4
  65.          4. Database format                                          7
  66.          5. Date specifiers                                          8
  67.          6. Notes about calendars                                   11
  68.          7. User Supported Software                                 13
  69.          8. Bug Reports                                             16
  70.          9. Known Problems/Limitations                              17
  71.          Appendices                                                 18
  72.              A. Bibliography                                        18
  73.              B. Program History                                     19
  74.  
  75.  
  76.  
  77.  
  78.  
  79.          On This Day                                       Version 1.5
  80.  
  81.          1. Introduction
  82.  
  83.          Have you ever been curious about events that happened on this
  84.          day in history?  On This Day is a collection of databases and
  85.          a printing interface which will generate a list of items of
  86.          note concerning today.  The databases sent to registered
  87.          users contain more than 15,000 entries (see section 7 for
  88.          more information about registration).
  89.  
  90.          Some of the types of information which may be displayed are:
  91.  
  92.                    - Astronomical events.
  93.  
  94.                    - Birthdays of famous people.
  95.  
  96.                    - Historical events.
  97.  
  98.                    - National observations.
  99.  
  100.                    - Religious holidays and events.
  101.  
  102.          In addition, a personal database may be created to contain
  103.          events important to each specific user.  Events such as
  104.          birthdays of relatives and friends may be appropriate for
  105.          this file.
  106.  
  107.          To clarify, the question this software is intending to answer
  108.          is:
  109.  
  110.          What historical events, religious holidays, etc. happened on
  111.          a particular date?
  112.  
  113.          It is not intended to answer questions like:
  114.  
  115.          What date is Easter next year?
  116.          When was John Wayne born?
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                        1 
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          On This Day                                       Version 1.5
  140.  
  141.          2. Command Line
  142.  
  143.          To run On This Day, use the following command line (note that
  144.          []s enclose optional arguments):
  145.  
  146.                    OTD [-b] [-e] [-p] [-r] [-d <date>]
  147.                        [-m <day-number>|all]
  148.  
  149.                    where:
  150.  
  151.                             -b  prints famous birthdays
  152.  
  153.                             -d  allows you to specify a date other
  154.                                 than today's date.  Date may be ANY
  155.                                 form specified in section 5, below.
  156.                                 Some may not make sense in actual use
  157.                                 (e.g. R(*) would only print stuff on
  158.                                 Thursdays.)  Note also that only items
  159.                                 that occurred before the date
  160.                                 specified will be printed.
  161.  
  162.                             -e  prints today's events
  163.  
  164.                             -p  prints today's personal events
  165.  
  166.                             -r  prints today's religious events
  167.  
  168.                             -m  indicates when to print monthly events
  169.                                 (<day-number> indicates the day each
  170.                                 month.  all indicates to print every
  171.                                 day.) (default: 1)  For example, the
  172.                                 command:  'otd -m 3' will print
  173.                                 today's events and if today is the
  174.                                 third day of the month, it will also
  175.                                 print any existing monthly events. For
  176.                                 more information on monthly events,
  177.                                 see section 5.
  178.  
  179.          Again, we must emphasize that it is NOT necessary to input
  180.          ANY arguments to the OTD command.  Simply typing "OTD"
  181.          (without the quotes, of course) will get you all the output
  182.          in the format that we believe most users want.  If you want
  183.          to alter the output in any way, use the options as described
  184.          above.
  185.  
  186.          Running OTD with none of the -b, -e, -p, or -r options is
  187.          the same as running with all the options.  If any of these
  188.          options are specified, only those categories will be
  189.          displayed.
  190.  
  191.  
  192.  
  193.                                        2 
  194.  
  195.  
  196.  
  197.  
  198.  
  199.          On This Day                                       Version 1.5
  200.  
  201.          DOS hints:
  202.  
  203.          Q:     How can I print the output of OTD?
  204.  
  205.          A:     Append '> PRN:' to your command line (e.g. OTD > PRN:
  206.                 will send today's information to the printer).
  207.  
  208.          Q:     It all goes by so quickly ... How do I get it to slow
  209.                 down so I can read it all?
  210.  
  211.          A:     Append '| MORE' to your command line (e.g. OTD | MORE
  212.                 will run OTD, displaying the results one screen at a
  213.                 time).  For more information on the MORE filter, see
  214.                 your DOS manual.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.                                        3 
  254.  
  255.  
  256.  
  257.  
  258.  
  259.          On This Day                                       Version 1.5
  260.  
  261.          3. Databases
  262.  
  263.          On This Day reads it's data from a subset of the following
  264.          databases:
  265.  
  266.  
  267.                    BIRTHDAY.JAN         EVENTS.JAN
  268.                    BIRTHDAY.FEB         EVENTS.FEB
  269.                    BIRTHDAY.MAR         EVENTS.MAR
  270.                    BIRTHDAY.APR         EVENTS.APR
  271.                    BIRTHDAY.MAY         EVENTS.MAY
  272.                    BIRTHDAY.JUN         EVENTS.JUN
  273.                    BIRTHDAY.JUL         EVENTS.JUL
  274.                    BIRTHDAY.AUG         EVENTS.AUG
  275.                    BIRTHDAY.SEP         EVENTS.SEP
  276.                    BIRTHDAY.OCT         EVENTS.OCT
  277.                    BIRTHDAY.NOV         EVENTS.NOV
  278.                    BIRTHDAY.DEC         EVENTS.DEC
  279.                    RELIGION             EVENTS.OTH
  280.                    PERSONAL
  281.  
  282.          Files in the current directory by these names will be used
  283.          first.  If they do not exist there, the environment variable
  284.          OTDDIR will be searched.  It has the same syntax as the PATH
  285.          environment variable.  That is, you could place all the
  286.          BIRTHDAY databases in one subdirectory and all EVENTS
  287.          databases in another specifying all these subdirectories in
  288.          the OTDDIR environment variable.  For example:
  289.  
  290.          SET OTDDIR=C:\OTD\BDAY;C:\OTD\EVT
  291.  
  292.          Or, you might want to place some of the databases on a disk
  293.          in each of two floppy drives on a floppy-only system.  In
  294.          this case, you might want to use the following setting to
  295.          enable OTD to search both places for data:
  296.  
  297.          SET OTDDIR=A:\;B:\
  298.  
  299.          Typically, however, this facility will be used so that the
  300.          OTD command may be invoked from anywhere on your disk and it
  301.          will find the appropriate data files in one directory.  For
  302.          example:
  303.  
  304.          SET OTDDIR=C:\OTD
  305.  
  306.          If the -d option has not been specified, the current date
  307.          from the system clock is used it to determine the extension
  308.          to use in the BIRTHDAY and EVENTS files.
  309.  
  310.          If you set the TZ environment variable, OTD will use that
  311.          value when printing times for astronomical events.  The
  312.  
  313.                                        4 
  314.  
  315.  
  316.  
  317.  
  318.  
  319.          On This Day                                       Version 1.5
  320.  
  321.          syntax of the TZ environment variable is:
  322.  
  323.          SET TZ=zzz[+/-]d[d][lll]
  324.  
  325.          zzz is a three character field representing the name of the
  326.          current time zone (e.g. EST, PST).
  327.  
  328.          [+/-]d[d] is an optionally signed number of one or more
  329.          digits.  It is the local time zone's difference from GMT in
  330.          hours.  Negative numbers adjust westward from GMT. (e.g.
  331.          5=EST, +8=PST, and -1=continental Europe).
  332.  
  333.          lll is an optional three-character field that represents the
  334.          local time zone daylight savings time (e.g. EDT, PDT).  Don't
  335.          include this field if your time zone does not have daylight
  336.          savings time.
  337.  
  338.          If the TZ environment variable isn't present or is not of the
  339.          above form, a default value of EST5EDT will be used.
  340.  
  341.          If birthday information was requested, BIRTHDAY.<mon> will be
  342.          read.  If events were requested, EVENTS.<mon> and EVENTS.OTH
  343.          will be read.  EVENTS.OTH is used for those events which
  344.          might be in different months in different years.  If
  345.          religious events were requested, RELIGION will be read.  If
  346.          personal events were requested, PERSONAL will be read.
  347.  
  348.          The entries will be printed as they are encountered in each
  349.          database.  If you want entries printed in a specific order,
  350.          they must be in that order in the database.
  351.  
  352.          OTD is distributed with all the above databases with the
  353.          exception of PERSONAL.  Note, however, that much larger and
  354.          more extensive databases will be sent to you should you
  355.          register your copy (see section 7 for more information about
  356.          this and other advantages of registration).
  357.  
  358.          Some of the databases distributed with the program may be
  359.          compressed.  This helps save disk space upon installation.
  360.          OTD determines dynamically whether a database is compressed
  361.          or not and reads it appropriately.  The compression and
  362.          decompression programs are distributed with the evaluation
  363.          version.
  364.  
  365.          You may, of course, replace any of our compressed databases
  366.          with your own in order to try out some of the features of the
  367.          event specification language.  Or, you may try out
  368.          interesting features in your PERSONAL database without
  369.          touching any of our databases.  The program itself is not
  370.          crippled in any way.  You have the ability to test all
  371.          functionality it is capable of performing.
  372.  
  373.                                        5 
  374.  
  375.  
  376.  
  377.  
  378.  
  379.          On This Day                                       Version 1.5
  380.  
  381.          Note that the information contained in the databases
  382.          distributed with the program has been taken from a great many
  383.          sources since sometime in 1985 or so.  We do not guarantee
  384.          their accuracy.  You may also find duplicate entries which
  385.          are not indicated in the database.  We would appreciate
  386.          hearing about these as we do try to weed out the duplicates
  387.          when and if we can find another source to collaborate one of
  388.          the dates.
  389.  
  390.          We are always interested in new dates.  If possible, please
  391.          try to give us supporting evidence of a new date.  We do not
  392.          want the databases to get any less reliable than they already
  393.          are.  In fact we want them to improve in reliability over
  394.          time.  We do, however, reserve the right not to add any date
  395.          to the database.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.                                        6 
  434.  
  435.  
  436.  
  437.  
  438.  
  439.          On This Day                                       Version 1.5
  440.  
  441.          4. Database format
  442.  
  443.          A line in the database file may be in one of the following
  444.          forms:
  445.  
  446.                    #:<stuff>
  447.  
  448.                         This line is ignored by OTD.  It is merely
  449.                         used to add commentary to the file.
  450.  
  451.                    <relative date specifier>:<stuff>
  452.  
  453.                         Should today match the relative date
  454.                         specifier, print the stuff to the standard
  455.                         output device.  See section 5 for more
  456.                         detailed information about date specifiers.
  457.  
  458.                    <blanks>:<stuff>
  459.  
  460.                         This type of line indicates a continuation of
  461.                         the line preceding for use when one line won't
  462.                         hold enough text.
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.                                        7 
  494.  
  495.  
  496.  
  497.  
  498.  
  499.          On This Day                                       Version 1.5
  500.  
  501.          5. Date specifiers
  502.  
  503.          Date specifiers may have one of the following forms:
  504.  
  505.          Absolute Dates -
  506.  
  507.                    <month-number>
  508.  
  509.                         If this month (in the specified calendar)
  510.                         matches <month-number> and the -m option
  511.                         specifies today as the print day, print the
  512.                         item.
  513.  
  514.                    <month-number>/<day>
  515.  
  516.                         If this month (in the specified calendar)
  517.                         matches <month-number> and this day matches
  518.                         <day>, print the item.
  519.  
  520.                    <month-number>/<day>/<year>
  521.  
  522.                         If this month (in the specified calendar)
  523.                         matches <month-number> and this day matches
  524.                         <day>, print the item with "In <year>,"
  525.                         prepended.
  526.  
  527.          Relative dates -
  528.  
  529.                    <alternate calendar><absolute date>
  530.  
  531.                         This form directs OTD to use the specified
  532.                         calendar to evaluate <absolute date>.  Valid
  533.                         <alternate calendar>s are:
  534.  
  535.                              G or <none> Gregorian
  536.                              H           Hebrew
  537.                              HF          Hebrew Fast Day
  538.                                          (will be moved to following
  539.                                           day if it is Saturday)
  540.                              I           Islamic
  541.                              J           Julian
  542.  
  543.                         See section 6 for short descriptions of these
  544.                         calendars.
  545.  
  546.                    <absolute date>+<days>
  547.  
  548.                         Add <days> to the date specified in <absolute
  549.                         date>.  For example, 1/3+37 is the same as
  550.                         2/9.
  551.  
  552.  
  553.                                        8 
  554.  
  555.  
  556.  
  557.  
  558.  
  559.          On This Day                                       Version 1.5
  560.  
  561.                    <absolute date>-<days>
  562.  
  563.                         Subtract <days> from the date specified in
  564.                         <absolute date>.  For example, 1/3-21 is the
  565.                         same as 12/13.
  566.  
  567.                    <wkday>(<month>/<day>)
  568.  
  569.                         This specifies the first <wkday> occurring on
  570.                         or before the date specified by <month> and
  571.                         <day>.  Valid values for <wkday> are:
  572.  
  573.                              M          Monday
  574.                              T          Tuesday
  575.                              W          Wednesday
  576.                              R          thuRsday
  577.                              F          Friday
  578.                              S          Saturday
  579.                              U          sUnday
  580.  
  581.                         For example, W(8/14) specifies the second
  582.                         Wednesday occurring in the month of August.
  583.  
  584.                    <wkday>(*)
  585.  
  586.                         This denotes every day that happens to fall on
  587.                         the specified <wkday>.  Valid values for
  588.                         <wkday> are:
  589.  
  590.                              M          Monday
  591.                              T          Tuesday
  592.                              W          Wednesday
  593.                              R          thuRsday
  594.                              F          Friday
  595.                              S          Saturday
  596.                              U          sUnday
  597.  
  598.                         For example, M(*) specifies every Monday.
  599.  
  600.                    E
  601.  
  602.                         This denotes the Christian holiday Easter.
  603.  
  604.                    E+<days>
  605.  
  606.                         This denotes a date <days> days following the
  607.                         Christian holiday Easter.  This format is
  608.                         necessary to specify all the Christian
  609.                         holidays as many are based upon Easter's date.
  610.  
  611.  
  612.  
  613.                                        9 
  614.  
  615.  
  616.  
  617.  
  618.  
  619.          On This Day                                       Version 1.5
  620.  
  621.                    E-<days>
  622.  
  623.                         This denotes a date <days> days before the
  624.                         Christian holiday Easter.  This format is
  625.                         necessary to specify all the Christian
  626.                         holidays as many are based upon Easter's date.
  627.  
  628.                    *
  629.  
  630.                         This denotes every day.
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.                                       10 
  674.  
  675.  
  676.  
  677.  
  678.  
  679.          On This Day                                       Version 1.5
  680.  
  681.          6. Notes about calendars
  682.  
  683.          Gregorian calendar
  684.  
  685.                 This calendar is the one in use currently by much of
  686.                 the world (including the United States).  It was
  687.                 designed by a commission assembled by Pope Gregory
  688.                 XIII in the sixteenth century.  It is based on the
  689.                 revolution of the earth about the sun.
  690.  
  691.                 The months and corresponding numbers that are legal
  692.                 for this calendar are:
  693.  
  694.                 January         1
  695.                 February        2
  696.                 March           3
  697.                 April           4
  698.                 May             5
  699.                 June            6
  700.                 July            7
  701.                 August          8
  702.                 September       9
  703.                 October         10
  704.                 November        11
  705.                 December        12
  706.  
  707.          Hebrew calendar
  708.  
  709.                 This calendar was placed in operation in the mid-
  710.                 fourth century by Hillel II.  It is based on the
  711.                 moon's revolution about the earth.  However, it has
  712.                 solar corrections built in.
  713.  
  714.                 The months and corresponding numbers that are legal
  715.                 for this calendar are:
  716.  
  717.                 Nisan   1
  718.                 Iyyar   2
  719.                 Sivan   3
  720.                 Tammuz  4
  721.                 Av      5
  722.                 Elul    6
  723.                 Tishri  7
  724.                 Heshvan 8
  725.                 Kislev  9
  726.                 Teveth  10
  727.                 Shevat  11
  728.                 Adar    12
  729.                 Adar II 13 {Note Adar is Adar I in years when
  730.                             there is an Adar II}
  731.  
  732.  
  733.                                       11 
  734.  
  735.  
  736.  
  737.  
  738.  
  739.          On This Day                                       Version 1.5
  740.  
  741.                 Certain holidays (fast days) must be moved to the
  742.                 following day (Sunday) if they fall on a Saturday.
  743.                 The HF calendar specifier allows you to indicate a
  744.                 Hebrew date is one of these "special" holidays.
  745.  
  746.                 Note that one holiday (Ta'anit Esther) occurs on the
  747.                 preceding Thursday when Purim is on a Sunday.  There
  748.                 is no way, currently, to specify this relationship.
  749.  
  750.          Islamic calendar
  751.  
  752.                 This calendar is based upon the moon revolving around
  753.                 the earth.  There are no dates in this calendar before
  754.                 Friday, July 16, 622 (Julian)
  755.  
  756.                 Much of the Islamic world does not agree with
  757.                 calculations to determine this calendar at all.  They
  758.                 only rely on proclamation of the new moon by the
  759.                 authorities at al-Azhar in Cairo to define the
  760.                 calendar.  Consequently, the dates computed here may
  761.                 differ by a day or two from those observed by much of
  762.                 the Islamic population of the world.
  763.  
  764.                 The months and corresponding numbers that are legal
  765.                 for this calendar are:
  766.  
  767.                 Muharram        1
  768.                 Safar           2
  769.                 Rabi I          3
  770.                 Rabi II         4
  771.                 Jumada I        5
  772.                 Jumada II       6
  773.                 Rajab           7
  774.                 Sha'ban         8
  775.                 Ramadan         9
  776.                 Shawwal         10
  777.                 Dhu al-Qada     11
  778.                 Dhu al-Hijjah   12
  779.  
  780.          Julian calendar
  781.  
  782.                 This calendar was instituted in 45 BC by Julius
  783.                 Caesar.  It, too, is based on the revolution of the
  784.                 earth about the sun.
  785.  
  786.                 The months for the Julian calendar are the same as
  787.                 those used for the Gregorian calendar.  See above for
  788.                 more information on the proper month numbers to use
  789.                 when constructing dates.
  790.  
  791.  
  792.  
  793.                                       12 
  794.  
  795.  
  796.  
  797.  
  798.  
  799.          On This Day                                       Version 1.5
  800.  
  801.          7. User Supported Software
  802.  
  803.          This program is produced by a member of the Association of
  804.          Shareware Professionals (ASP).  ASP wants to make sure that
  805.          the shareware principle works for you.  If you are unable to
  806.          resolve a shareware-related problem with an ASP member by
  807.          contacting the member directly, ASP may be able to help.  The
  808.          ASP Ombudsman can help you resolve a dispute or problem with
  809.          an ASP member, but does not provide technical support for
  810.          members' products.  Please write to the ASP Ombudsman at 545
  811.          Grover Road, Muskegon, MI  49442 or send a CompuServe message
  812.          via CompuServe Mail to ASP Ombudsman 70007,3536.
  813.  
  814.          DEFINITION OF SHAREWARE
  815.  
  816.          Shareware distribution gives users a chance to try software
  817.          before buying it.  If you try a Shareware program and
  818.          continue using it, you are expected to register.  Individual
  819.          programs differ on details -- some request registration while
  820.          others require it, some specify a maximum trial period.  With
  821.          registration, you get anything from the simple right to
  822.          continue using the software to an updated program with
  823.          printed manual.
  824.  
  825.          Copyright laws apply to both Shareware and commercial
  826.          software, and the copyright holder retains all rights, with a
  827.          few specific exceptions as stated below.  Shareware authors
  828.          are accomplished programmers, just like commercial authors,
  829.          and the programs are of comparable quality.  (In both cases,
  830.          there are good programs and bad ones!)  The main difference
  831.          is in the method of distribution.  The author specifically
  832.          grants the right to copy and distribute the software, either
  833.          to all and sundry or to a specific group.  For example, some
  834.          authors require written permission before a commercial disk
  835.          vendor may copy their Shareware.
  836.  
  837.          Shareware is a distribution method, not a type of software.
  838.          You should find software that suits your needs and
  839.          pocketbook, whether it's commercial or Shareware.  The
  840.          Shareware system makes fitting your needs easier, because you
  841.          can try before you buy.  And because the overhead is low,
  842.          prices are low also.  Shareware has the ultimate money-back
  843.          guarantee -- if you don't use the product, you don't pay for
  844.          it.
  845.  
  846.          DISCLAIMER - AGREEMENT
  847.  
  848.          Users of On This Day must accept this disclaimer of warranty:
  849.          "On This Day is supplied as is.  The author disclaims all
  850.          warranties, expressed or implied, including, without
  851.          limitation, the warranties of merchantability and of fitness
  852.  
  853.                                       13 
  854.  
  855.  
  856.  
  857.  
  858.  
  859.          On This Day                                       Version 1.5
  860.  
  861.          for any purpose.  The author assumes no liability for
  862.          damages, direct or consequential, which may result from the
  863.          use of On This Day."
  864.  
  865.          On This Day is a "shareware program" and is provided at no
  866.          charge to the user for evaluation.  Feel free to share it
  867.          with your friends, but please do not give it away altered or
  868.          as part of another system.  The essence of "user-supported"
  869.          software is to provide personal computer users with quality
  870.          software without high prices, and yet to provide incentive
  871.          for programmers to continue to develop new products.  If you
  872.          find this program useful and find that you are using On This
  873.          Day and continue to use On This Day after a reasonable trial
  874.          period, you must make a registration payment of $25.00 (US
  875.          funds) to The Software Construction Co.  Massachusetts
  876.          residents should include $1.25 sales tax.  The registration
  877.          fee will license one copy for use on any one computer at any
  878.          one time.  You must treat this software just like a book.  An
  879.          example is that this software may be used by any number of
  880.          people and may be freely moved from one computer to another,
  881.          so long as there is no possibility of it being used in two
  882.          locations simultaneously.  Just as a book cannot be read by
  883.          two different persons at the same time.
  884.  
  885.          Commercial users of On This Day must register and pay for
  886.          their copies of On This Day within 30 days of first use or
  887.          their license is withdrawn.  Site-License arrangements may be
  888.          made by contacting The Software Construction Co.
  889.  
  890.          Anyone distributing On This Day for any kind of remuneration
  891.          must first contact The Software Construction Co. via one of
  892.          the means below for authorization.  This authorization will
  893.          be automatically granted to distributors recognized by the
  894.          (ASP) as adhering to its guidelines for shareware
  895.          distributors, and such distributors may begin offering On
  896.          This Day immediately (However The Software Construction Co.
  897.          must still be advised so that the distributor can be kept up-
  898.          to-date with the latest version of On This Day).
  899.  
  900.          You are encouraged to pass a copy of On This Day along to
  901.          your friends for evaluation.  Please encourage them to
  902.          register their copy if they find that they can use it.  All
  903.          registered users will receive a copy of the latest version of
  904.          On This Day.
  905.  
  906.          If you have received this software through one of the so
  907.          called "Shareware Houses" (companies whose business is
  908.          selling disks containing other author's software), please
  909.          note that none of the money you have paid so far has (or
  910.          will) make its way to the author.  You have simply paid for
  911.          the duplication and distribution costs.
  912.  
  913.                                       14 
  914.  
  915.  
  916.  
  917.  
  918.  
  919.          On This Day                                       Version 1.5
  920.  
  921.          Registration benefits include:
  922.  
  923.                    - Notification of any updates.
  924.  
  925.                    - The latest version of the software.
  926.  
  927.                    - A much more extensive collection of data.
  928.  
  929.                    - Several other utilities which make the
  930.                      maintenance of the databases much easier.
  931.                      
  932.                    - A database of interesting and humorous quotations
  933.                      and a program to select and print them out.
  934.  
  935.          Although we encourage copying and sharing of On This Day to
  936.          distribute our product, we must insist that you NOT share the
  937.          utilities, compression/decompression programs, and larger
  938.          databases you will receive upon registration.  We retain full
  939.          copyrights to these files.  It is an infringement of
  940.          copyright law to distribute copies of these files.
  941.  
  942.          Please see the read.me file for information on creating a
  943.          shareable copy of On This Day.
  944.  
  945.          Please contact us at:
  946.  
  947.                           The Software Construction Co.
  948.                                  P.O. Box 160
  949.                            North Billerica, MA   01862
  950.  
  951.          Alternatively, you may contact us on CompuServe at 70313,3615
  952.          or on GEnie at W.GEISER or on the Internet at
  953.          softcons@world.std.com
  954.  
  955.          Other ways of registering (besides directly through us) can
  956.          be found on the registration form, REGISTER.DOC.
  957.  
  958.          If you do not use this software, we'd also like to know why.
  959.          We'd like to know how we can make this product better.
  960.          Please let us know what we could have done to make it useful
  961.          or interesting to you.
  962.  
  963.          For $5 to cover the cost of the diskette(s) and shipping
  964.          (refunded when you register), we will supply you with the
  965.          latest edition of the software.  Please specify if you'd like
  966.          5.25" or 3.5" diskettes.
  967.  
  968.          We would sincerely like to thank you for giving this, the
  969.          fruits of our labor, a trial.  We hope it proves useful to
  970.          you.
  971.  
  972.  
  973.                                       15 
  974.  
  975.  
  976.  
  977.  
  978.  
  979.          On This Day                                       Version 1.5
  980.  
  981.          8. Bug Reports
  982.  
  983.          Should you discover a bug in this code, please let us know
  984.          using one of the mechanisms listed in section 7.  We regret
  985.          that we can't provide phone support at this time (maybe in
  986.          the future).  Provide us with as much of a description of the
  987.          problem as you can, as well as your name and address.  If you
  988.          would prefer being contacted by phone, by all means, add your
  989.          phone number and the hours you will be available at that
  990.          number.
  991.  
  992.          What do you get for your trouble?  We will send a copy of the
  993.          fixed program to the first registered user to report the
  994.          problem and will strive to answer all others with a letter.
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.                                       16 
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.          On This Day                                       Version 1.5
  1040.  
  1041.          9. Known Problems/Limitations
  1042.  
  1043.          a.     The Jewish holiday Ta'anit Esther occurs on the
  1044.                 preceding Thursday when Purim falls on Sunday.  There
  1045.                 is no way, currently, to indicate this relationship.
  1046.                 We are not sure that this functionality will ever be
  1047.                 included as this relationship is extraordinarily rare.
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.                                       17 
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.          On This Day                                       Version 1.5
  1100.  
  1101.          A. Bibliography
  1102.  
  1103.          Special thanks to John Peyton, a friend who helped get me
  1104.          thinking along the right path several times.
  1105.  
  1106.          Following is a list (no doubt partial) of items I found
  1107.          helpful when learning how to calculate the various calendars,
  1108.          astronomical events, etc. that are contained in the software:
  1109.  
  1110.          Astronomical Formulae for Calculators by Jean Meeus, 1982,
  1111.                 Willmann-Bell, Inc.
  1112.  
  1113.          Calendrical Calculations by Edward M. Reingold and Nachum
  1114.                 Dershowitz, 1989, University of Illinois at Urbana-
  1115.                 Champaign.
  1116.  
  1117.          Practical Astronomy With Your Calculator by Peter Duffett-
  1118.                 Smith, 3rd edition 1988, Cambridge University Press.
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.                                       18 
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.          On This Day                                       Version 1.5
  1160.  
  1161.          B. Program History
  1162.  
  1163.          Version 1.0 - April 1990.
  1164.  
  1165.          Version 1.1 - July 1991.
  1166.  
  1167.                 - Phases of the moon added.
  1168.  
  1169.                 - Lunar eclipses added.
  1170.  
  1171.                 - Compression for databases.
  1172.  
  1173.                 - Serial numbers to track distribution better.
  1174.  
  1175.                 - TZ environment variable controls times for
  1176.                   astronomical events.
  1177.  
  1178.                 - A few minor bug fixes.
  1179.  
  1180.                 - CompuServe support offered.
  1181.  
  1182.                 - New installation utility.
  1183.  
  1184.          Version 1.2 - October 1992.
  1185.  
  1186.                 - Registrations accepted by PsL and BUDGETWARE.
  1187.  
  1188.                 - GEnie support offered.
  1189.  
  1190.          Version 1.3 - October 1992.
  1191.  
  1192.                 - Database update.
  1193.  
  1194.          Version 1.4 - January 1993.
  1195.          
  1196.                 - Database update.
  1197.  
  1198.                 - Minor bugfixes.
  1199.  
  1200.                 - Quotation database added as registration incentive.
  1201.  
  1202.  
  1203.          Version 1.5 - May 1993.
  1204.  
  1205.                 - Database update.
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.                                       19 
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.    - A -
  1222.  
  1223.          absolute dates                 <see dates, absolute>
  1224.          address, CompuServe            15
  1225.          address, US Mail               15
  1226.          agreement                      13
  1227.          alternate date specification   2
  1228.          ASP Ombudsman                  13
  1229.          Assoc. of Shareware Prof.      13
  1230.          astronomical events            <see events, astronomical>
  1231.  
  1232.    - B -
  1233.  
  1234.          birthdays                      1, 2, 5
  1235.          bugs                           16
  1236.  
  1237.    - C -
  1238.  
  1239.          calendar, Gregorian            8, 11
  1240.          calendar, Hebrew               8, 11
  1241.          calendar, Islamic              8, 12
  1242.          calendar, Julian               8, 12
  1243.          calendars                      11
  1244.          command line                   2
  1245.          command line options           2
  1246.          comments                       7
  1247.          compression                    5
  1248.          continuation lines             7
  1249.  
  1250.    - D -
  1251.  
  1252.          database format                7
  1253.          databases                      4
  1254.          date specifiers                8
  1255.          dates, absolute                8
  1256.          dates, relative                8
  1257.          decompression                  5
  1258.          disclaimer                     13
  1259.  
  1260.    - E -
  1261.  
  1262.          Easter                         9
  1263.          events                         2, 5
  1264.          events, astronomical           1
  1265.          events, historical             1
  1266.          events, monthly                2
  1267.          events, personal               2, 5
  1268.          events, religious              1, 2, 5
  1269.  
  1270.    - G -
  1271.  
  1272.          Gregorian calendar             <see calendar, Gregorian>
  1273.  
  1274.    - H -
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.          Hebrew calendar                <see calendar, Hebrew>
  1281.          Hillel II                      11
  1282.          historical events              <see events, historical>
  1283.  
  1284.    - I -
  1285.  
  1286.          introduction                   1
  1287.          Islamic calendar               <see calendar, Islamic>
  1288.  
  1289.    - J -
  1290.  
  1291.          Julian calendar                <see calendar, Julian>
  1292.          Julius Caesar                  12
  1293.  
  1294.    - L -
  1295.  
  1296.          limitations                    17
  1297.  
  1298.    - M -
  1299.  
  1300.          monthly events                 <see events, monthly>
  1301.  
  1302.    - N -
  1303.  
  1304.          national observances           1
  1305.  
  1306.    - O -
  1307.  
  1308.          options, command line          <see command line options>
  1309.          OTDDIR environment variable    4
  1310.  
  1311.    - P -
  1312.  
  1313.          PATH environment variable      4
  1314.          personal events                <see events, personal>
  1315.          Pope Gregory XIII              11
  1316.          problems                       16
  1317.          problems, known                17
  1318.  
  1319.    - R -
  1320.  
  1321.          registration information       5
  1322.          relative dates                 <see dates, relative>
  1323.          religious events               <see events, religious>
  1324.          religious holidays             <see events, religious>
  1325.          reporting bugs                 16
  1326.  
  1327.    - S -
  1328.  
  1329.          shareware                      13
  1330.  
  1331.    - T -
  1332.  
  1333.          time zone                      <see TZ environment variable>
  1334.          TZ environment variable        4
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.    - U -
  1341.  
  1342.          user supported software        <see shareware>
  1343.  
  1344.    - Misc -
  1345.  
  1346.          -m option                      8
  1347.  
  1348.  
  1349.  
  1350.  
  1351.                           The Software Construction Co.
  1352.                                   P.O. Box 160
  1353.                            North Billerica, MA  01862
  1354.                                  CIS: 70313,3615
  1355.                                  GEnie: W.GEISER
  1356.                          Internet: softcons@world.std.com
  1357.  
  1358.         Name:    ________________________________________________________
  1359.  
  1360.         Address: ________________________________________________________
  1361.  
  1362.                  ________________________________________________________
  1363.  
  1364.                  ________________________________________________________
  1365.  
  1366.         Phone:   ________________________________________________________
  1367.  
  1368.         Where did you get your copy of On This Day (version 1.5)?
  1369.  
  1370.         The Software Construction Co. _____        BBS              _____
  1371.  
  1372.         Friend                        _____        Shareware Dealer _____
  1373.  
  1374.         If you checked BBS or Shareware Dealer above please tell us which
  1375.         one:
  1376.  
  1377.         _________________________________________________________________
  1378.  
  1379.         What format media would you like?         5.25" _____  3.5" _____
  1380.  
  1381.         Comments or suggestions: ________________________________________
  1382.  
  1383.         _________________________________________________________________
  1384.  
  1385.         _________________________________________________________________
  1386.  
  1387.         _________________________________________________________________
  1388.  
  1389.         _________________________________________________________________
  1390.  
  1391.         _________________________________________________________________
  1392.  
  1393.         On This Day can be ordered from the following sources in addition
  1394.         to directly from The Software Construction Co.:
  1395.  
  1396.         Public (software) Library               BUDGETWARE
  1397.         P.O. Box 35705                          P.O. Box 496
  1398.         Houston, TX   77235-5705                Newtown NSW 2042
  1399.         USA                                     AUSTRALIA
  1400.         (800) 2424-PsL or (713) 524-6394        (02) 519-4233
  1401.         (713) 524-6398 FAX                      (02) 516-4236 FAX
  1402.         CIS email: 71355,470
  1403.  
  1404.         Note: These sources are for orders only!  ALL other correspondence
  1405.               should be directed to The Software Construction Co.
  1406.  
  1407.